home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / windows / icnmvr23.zip / README.TXT < prev    next >
Text File  |  1996-01-05  |  16KB  |  362 lines
  1. Icon Mover 2.3
  2. 12/20/95
  3.  
  4. Integrated Graphics
  5. 312 Nevada St.
  6. Northfield, MN 55057-2345
  7.  
  8. E-mail: hansonr@stolaf.edu
  9.  
  10. INTRODUCTION
  11. ------------
  12.  
  13. Icon Mover 2.3, ICONMOVR.EXE, enables a user to transfer standard Windows3.1 
  14. icon and icon-related device-independent bitmaps (32x32, 16-color) from one 
  15. application or group of applications to another. Transfer of icon bitmaps 
  16. between any two ICO, BMP, DLL, EXE, FRX, VBX, etc... files is supported. 
  17. Icon Mover finds all bitmaps any file or directory of files, displaying up 
  18. to 1000 at a time, and can read icons from most GRP files. All icons stored 
  19. in files are located, even including those not known to Windows. All such 
  20. bitmaps are displayed graphically and moved by clicking and dragging of 
  21. the mouse. Alternatively, icons can be extracted into ICO, BMP, DLL, or DLX 
  22. (expandable DLL) files directly by right-clicking on them. A 10-icon cache 
  23. is preserved between sessions.  
  24.   In addition, icons can be extracted from BMP files of any size
  25. or format by simply "driving" an icon "window" around the bitmap,
  26. selecting the portion of the bitmap desired as an icon. Bitmaps may be
  27. scaled up or down by a factor up to 16 prior to icon extraction.
  28. Icons produced from bitmaps may be opaque or transparent, as desired.
  29.   Icon Mover 2.3 introduces a completely new method of working with icons 
  30. in terms of DLL libraries. The "expandable DLL" files (default extension 
  31. "DLX") created by Icon Mover expand to fit up to 2544 icons with less than 
  32. 10% overhead. DLX files are fully readable by Program Manager and Windows 
  33. API functions such as ExtractIcon. Alternatively, icons can be stored in 
  34. libraries created simply with a DOS command such as COPY *.ICO MYLIB.ICO.
  35.   Alhough Icon Mover is not an icon editor, Version 2.3 introduces an
  36. interface which allows editing of icons and bitmaps via an external icon
  37. editor. A sample icon editor is included as ICONEDIT.EXE.
  38.  
  39. CHANGES SINCE ICON MOVER 2.2
  40. ----------------------------
  41. New setup.exe only
  42.  
  43. CHANGES SINCE ICON MOVER 1.3
  44. ----------------------------
  45. 1. Multiple selects allowed so that several icon-bearing
  46.    files can be inspected and extracted from at once. (REGISTERED
  47.    VERSION ONLY)
  48.  
  49. 2. Expandable DLL files for icon storage allow addition of icons
  50.    at any time to a pre-existing icon library.
  51.  
  52. 3. BMP file reading/writing supported, including scanning of bitmaps
  53.    prior to scaling and extracting a portion of the bitmap for use
  54.    as the icon.
  55.  
  56. 4. 10-Icon cache can be loaded and copied from within Icon Mover.
  57.  
  58. 5. Icons may be edited via an interface to an external icon editor.
  59.  
  60.  
  61. INSTALLATION
  62. ------------
  63. IcnMvr23.zip can be unzipped using PKUNZIP, PKUNZJR, or WINZIP. 
  64. If you do not have one of these programs, you can probably find
  65. one on the site from which you got IcnMvr23.zip. In addition, 
  66. you will need VBRUN300.DLL, as this program was produced using
  67. Microsoft Visual Basic 3.0 for Windows.
  68.  
  69. 1. Create a new temporary directory or choose one already on 
  70.    your hard disk.
  71.  
  72. 2. Move IcnMvr23.zip to this directory and unzip it there.
  73.  
  74. 3. From the Windows file manager Run...   thatdirectory\setup
  75.  
  76.    You will be asked to enter a directory into which to install 
  77.    Icon Mover (default is C:\iconmovr). Installation should 
  78.    complete in a few seconds. Installation will not change files  
  79.    in your WINDOWS or WINDOWS\SYSTEM directory. However, if installation 
  80.    or running of ICONMOVR indicates a file is missing or out of date,
  81.    transfer the file from C:\iconmovr to C:\windows\system and try 
  82.    again.
  83.  
  84. 4. Files in the temporary directory may be deleted. If you find   
  85.    that APIGUIDE.DLL, GRID.VBX, or CMDIALOG.VBX are duplicates in your 
  86.    WINDOWS\SYSTEM directory, you may delete them from C:\ICONMOVR
  87.  
  88. RUNNING THE PROGRAM
  89. -------------------
  90.  
  91. First designate a source file, either by clicking on "source:"
  92. or by using the pull-down menu. Using CTRL or SHIFT with the mouse
  93. you can designate more than one file, perhaps even the whole directory.
  94. Similarly indicate the destination file.
  95.   To load the cache, simply double-click on either a source or 
  96. destination icon. Once the cache is full, the currently highlighted 
  97. cache icon will be replaced. (Clicking on a cached icon highlights it.)
  98.   To install a cached icon in the destination file, drag a cached 
  99. icon to the destination icon you wish to replace. The original 
  100. destination icon will be swapped into the cache as long as the 
  101. "Swap icon on install" checkbox is checked. If this box is not 
  102. checked, then the old destination icon will be discarded.
  103.   Alternatively, you can right-click on any icon to extract it to 
  104. an ICO, BMP, DLL, or DLX file directly. Highlighting a block of icons 
  105. enables direct transfer from source to destination, or from source or 
  106. destination to an expandable DLL library. Additional icons may be added 
  107. to these files at any time. Though given the designation DLX, these files 
  108. are true DLL files in all respects. 
  109.   Icon Mover finds all valid icons in these files based on a bitmap 
  110. "header" of 12 bytes for *.GRP files and 20 bytes for other files. 
  111. Thus, there is a very small chance that Icon Mover can CONCEIVABLY be 
  112. fooled into thinking that an icon exists when it really doesn't. 
  113. Use your own judgement: 
  114.  
  115.      If it doesn't look like an icon, including just plain blank,
  116.  
  117.             DON'T REPLACE IT!!!
  118.  
  119.  
  120. EXAMPLES OF USE OF ICON MOVER
  121. -----------------------------
  122.  
  123. Replacing a specific icon in a specific file
  124.  
  125.        Open the source dialog and select the source file containing the 
  126.          icon you want
  127.        Double-Click on the icon to copy it into the icon cache
  128.        Open the destination dialog and select the destination file you want
  129.        Drag the icon from the cache to the icon in the destination file
  130.          you want to replace
  131.        Note that the icons are swapped--the old icon is now in the cache
  132.          swapping can be disabled by unchecking the 'swap icon' checkbox
  133.          in the lower right-hand corner of your screen.
  134.  
  135. Loading a whole directory of icons into an expandable DLL library
  136.  
  137.        Open the source dialog and select all of the icons in a directory
  138.        (shift-left-drag down the menu of listed files).
  139.        From the File menu, select 'Select All Source Icons'.
  140.        Right-click on the block of highlighted icons and select 'append
  141.        to DLX library'. You will have the choices (a) whether to preserve
  142.        the current contents of the library or not and (b) whether to open
  143.        the library as the destination. The latter option is slower, but more
  144.        fun and often quite useful. 
  145.  
  146. Adding one or several icons to an existing expandable DLL library
  147.  
  148.        Open the source dialog and select one or more files containing icons
  149.        (CTRL-left-click on the desired files).
  150.        From the File menu, select 'Select All Source Icons', or select a
  151.        block of icons as displayed, and right-click on the block.
  152.        Select 'append to DLX library' from the popup menu.
  153.  
  154. Note: In all of the above operations, the target DLL file need not be 
  155. loaded as the destination when the transfer is made. Alternatively, you 
  156. can open the library as the destination file. In that case, you can see
  157. the library being built, but the action is a bit slower due to the need to 
  158. redisplay the possibly quite large library.
  159.  
  160. Caching source icons for use later
  161.  
  162.        Open the source dialog and select one or more files containing icons.
  163.        Double-left click on an icon to cache it. If desired, a specific 
  164.        cache icon can be replaced by first clicking on IT, then double-
  165.        clicking on a source icon. 
  166.  
  167. Caching destination icons for use later
  168.  
  169.        Same as for source, except only one file may be opened at a time as a
  170.        destination. Double-left click on the destination icon to cache it. 
  171.  
  172. Replacing an icon in any file from the cache
  173.  
  174.        Cache an icon as described above.
  175.        Open a destination file of any type.
  176.        Ensure that the 'Swap Icon on Install' checkbox is checked unless
  177.        you really want to permanently lose the icon to be replaced.
  178.        Drag a cached icon over the destination icon to be replaced.
  179.        Release the left button. The cached and destination icons will
  180.        switch location; the old icon can be replaced by simply repeating
  181.        the drag one more time.
  182.  
  183. Replacing an icon in an ICO or BMP file without using the cache
  184.  
  185.        Open the source dialog and select one or more files containing icons.
  186.        Now right-click on a source icon and select 'save as ICO file' or
  187.        'save as BMP file', as you prefer, from the pop-up menu. 
  188.        Alternatively, you can open the ICO or BMP filename as the 
  189.        destination and select 'transfer to destination'. 
  190.  
  191. Note: The popup menu is available from source, cache, and destination.
  192.        
  193. Note: It is recommended that you use the cache method, with the 'Swap icon 
  194. on install' checkbox checked. Replacing icons in ICO and BMP files without 
  195. caching does just that--imediately and permanently. As a built-in precaution,
  196. You will not be allowed to do replace any EXE, DLL, or DLX file icons directly,
  197. without using the cache. In addition, Icon Mover will not replace icons in
  198. Program Manager GRP files.
  199.  
  200.  
  201. Converting icons from any source to ICO format
  202.  
  203.        Open the source dialog and select one or more files containing icons.
  204.        Right-click on an icon and select 'save to ICO file'. If the source
  205.        is a BMP file, then you will get a chance to scan the bitmap to
  206.        determine what portion of it to make into an icon. Also decide
  207.        whether you want the icon to be transparent or not (whether it has a
  208.        cut-out image or appears square-backed on your screen).
  209.  
  210. Converting icons from any source to BMP format
  211.  
  212.        Open the source dialog and select one or more files containing icons.
  213.        Right-click on the icon and select 'save to BMP file'.
  214.        A dialog will prompt for a filename. 
  215.        The BMP format loses part of the icon called the AND mask, which is
  216.        used to make a "cutout" of the icon. Icon Mover allows you to retain
  217.        this AND mask by giving you the option to give the mask an unused
  218.        color from the color table. If you ever turn this bitmap back into an
  219.        icon, you can select that color as the color to make transparent. 
  220.  
  221. Creating icons from bitmaps
  222.  
  223.        Open the source dialog and select one or more ".BMP" files. All of
  224.        the above operations will be accessible; upon extracting, a form will
  225.        appear which allows you to choose (a) what part of the bitmap to use
  226.        for the icon, (b) what scale to use, and (c) whether you want one of
  227.        the colors (usually a background color) to be transparent. Click on
  228.        OK to accept, CHECK to see what the icon will look like (especially
  229.        useful if scaling has been done), or CANCEL to cancel the extraction.
  230.  
  231. Rearranging icons in any single file (other than GRP files)
  232.  
  233.        Open the file you wish to rearrange both as the source and as the
  234.        destination. Ensure that the 'Swap Icon on Install' checkbox is
  235.        checked. Transfer icons via the cache from source to destination.
  236.        Changes will automatically be reflected in both displays.
  237.  
  238. Editing icons and bitmaps
  239.  
  240.        From either the cache or the destination you may use the
  241.        pop-up menu to edit an icon. Prior to the first time you
  242.        edit an icon, use 'Options Editor' to setup the command
  243.        line for the icon editor of your choice. If your editor has
  244.        the capability of starting editing from a command line 
  245.        argument such as "C:\vb\iconwrks myfile.ico" then you will
  246.        be able to do that from Icon Mover as well. If it can't, then
  247.        Icon Mover will at least put the temporary file name used 
  248.        for the editing session in the clipboard. You can use CTRL-V
  249.        or SHIFT-Insert to retrieve it into your editor. Icon Mover
  250.        will wait to continue until the editor is closed.
  251.  
  252. COMMAND LINE OPTIONS
  253. --------------------
  254.  
  255. You can start up ICONMOVR indicating source and destination files right on
  256. the command line. Use the Program Manager File Run... command. Something
  257. like the following will work:
  258.  
  259.            C:\ICONMOVR\ICONMOVR  source.dlx  destin.dlx
  260.  
  261. These files, of course, can be of any valid format or type. This only loads the
  262. display; it doesn't actually do any icon moving. 
  263.  
  264. ICONMOVR.INI
  265. ------------
  266.  
  267. Icon Mover will establish an initialization file, ICONMOVR.INI, in
  268. its home directory. It looks something like this:
  269.  
  270. [Files]
  271. Source=C:\WIN\ACCESSOR.GRP
  272. Destination=C:\VB\__MINE\ICONMOVR\ICONMVR1.FRX
  273. Save=C:\VB\__MINE\ICONMOVR\T2B.ICO
  274. Cache=C:\WINDOWS\ICONCACH.DLX
  275. ICO-type=C:\VB\__MINE\ICONMOVR\T2B.ICO
  276. BMP-type=C:\VB\__MINE\ICONMOVR\TESTING.BMP
  277. DLX-type=C:\WINDOWS\GRPICONS.DLX
  278.  
  279. [Video]
  280. ColorPlanes=4
  281. Bits/Pixel=1
  282.  
  283. [DLLs]
  284. ExpansionMinimum=5 icons
  285.  
  286. [Options]
  287. Display=SHORT DISPLAY
  288. DisplayMaximum=1000
  289. ExpansionMaximum=2400
  290. Editor=C:\VB\ICONWRKS %S
  291.  
  292. [Registration]
  293. Name=Bob Hanson
  294. SerialNumber=34348397
  295.  
  296. These items are fairly self-expanatory. You may wish to change the 
  297. cache file designation; it must be an expandable DLL file.
  298. IconMover also worked when ColorPlanes=8 and Bits/Pixel=1. This only
  299. affects the operation of reading and caching *.GRP files. If you find
  300. that your *.GRP files can't be read, send me your ICONMOVR.INI file 
  301. by E-mail and I will try to enhance IconMover to work for your's, too. 
  302.  
  303. If you move ICONMOVR.EXE to a new home directory, be sure to move
  304. ICONMOVR.INI with it.
  305.  
  306. SOFTWARE LIMITATIONS
  307. --------------------
  308. Limitations are to display only the first 1000 icons in source files
  309. and only the first 1000 in destination files. Over 400 icons have been 
  310. successfully loaded at once. The number of files allowed as a group of
  311. source files depends upon the length of their filenames. Approximately
  312. 300-400 files at once should be no problem.
  313.  
  314.  
  315. HARDWARE REQUIREMENTS
  316. ---------------------
  317. Any computer capable of running Windows 3.1 should be adequate. 
  318. Since Icon Mover does not use sophisticated Windows API calls which
  319. involve device-dependent bitmaps, it is not screen- or graphics-board 
  320. dependent in any known way. It has been tested on both 386 and 486 
  321. machines having from 4 to 16 Mb of RAM with 16-256 colors and running 
  322. Windows 3.1 or Windows For Workgroups 3.11. 
  323.  
  324. REGISTRATION
  325. ------------
  326. Icon Mover is fully functional shareware. It is fully 
  327. distributable only in the form of ICNMVR23.ZIP. To remove the 
  328. startup registration screen, send US$20 or the equivalent to:
  329.  
  330. Integrated Graphics
  331. 312 Nevada St.
  332. Northfield, MN 55057-2345
  333. USA
  334.  
  335. Please provide your full E-mail address or regular mail 
  336. address in your request. A valid serial number will be sent
  337. by mail or E-mail. Add $5 for a 3.5" floppy containing the
  338. latest version. A single-user license permits a licensed user to 
  339. execute Icon Mover only on a single computer. Licensed users may 
  340. use the program on different computers as long as there is no 
  341. possibility of it being used at one location while it is being 
  342. used at another, or on a network by more than one user at a time.
  343.  
  344. FEEDBACK
  345. --------
  346.  
  347. Much of what you are using is the result of feedback from users of earlier
  348. versions of Icon Mover. Your feedback is greatly appreciated. If there is 
  349. ANYTHING that you don't like or anything that you would like to see, please
  350. E-mail it to me. I can install a newer test version on the St. Olaf College 
  351. ftp site, ftp.stolaf.edu/pub/origami/win,  ususally within a day or two. 
  352.  
  353. Have fun! 
  354.  
  355. Bob Hanson
  356. Integrated Graphics
  357. 312 Nevada St.
  358. Northfield, Minnesota  55057-2345
  359. hansonr@stolaf.edu
  360.  
  361.  
  362.